Operators importeren/exporteren

Er zijn twee REST-webservices voor het importeren en exporteren van operatorgegevens.

Operators importeren

Invoerparameters:

  • Operators.ZIP
  • Locatienaam

Operators.ZIP kan een of meer mappen bevatten. Elke map moet het volgende bevatten:

  • Het bestand OperatorId.json
  • Het zip-bestand met stemsjablonen waarin alle getrainde woorden van de operator zijn opgenomen.

Bij het importeren van één operator heeft u alleen de parameter operatorId nodig. Er is geen parameter vereist bij het importeren van meerdere operators.

U kunt zowel nieuwe als bestaande operators maken met REST.

Reactiecodes

200 OK: alle operators zijn geïmporteerd

400 Ongeldig verzoek: content van het zip-bestand is ongeldig

207 Meerdere statussen: Sommige operators zijn wel, andere zijn niet geïmporteerd. De foutmelding bevat informatie over alle operators die niet zijn geïmporteerd.

Operators exporteren

URL (één operator): http://serverip:port/VoiceCheck/services/operator/{operatorId}

waar operatorId de aanmeldnaam van de operator is; operator twieringa wordt bijvoorbeeld:
http://serverip:port/VoiceCheck/services/operator/{tsmith}

URL (alle operators): http://serverip:port/VoiceCheck/services/operators/

Om meerdere maar niet alle operators te importeren, roept u de REST-service voor één operator n keer op.

Methode: (GET), Type content (application/json;charset=UTF-8)

Reactie
Succes: HTTP-status 200 met of zonder tekst
Mislukt: Het systeem retourneert een foutmelding.

Resultaat: een zip-bestand met de operatorgegevens.

Inhoud en indeling van import/exportbestanden

Het bestand moet een zip-bestand zijn. Het zip-bestand bevat net zoveel mappen als er operators zijn. Als er bijvoorbeeld vijf operators worden geïmporteerd of geëxporteerd, bevat het zip-bestand vijf mappen, één map voor elke operator.

Elke map bevat:

  1. Een operator.json-bestand: dit bestand bevat operator-informatie, waaronder de id, naam en e-mail van de operator, plus een gecodeerd wachtwoord en toegangscode. Voorbeeld: ben.json
  2. Een zip-bestand dat alle sjablonen voor die operator bevat. De naam van het zip-bestand is "operatorID_templates.zip" (Voorbeeld: ben_templates.zip)
    • Dit zip-bestand bevat .bt2-bestanden. Dit zijn de sjabloonbestanden voor de operator
    • Indeling van de .bt2-bestandsnamen is "Taal_operator_vocab.bt2" (Bijvoorbeeld: %nl-NL%_ben_alpha.bt2)